home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / gtbimd11.zip / GTBIMDIR.DOC < prev    next >
Text File  |  1991-02-12  |  6KB  |  131 lines
  1. Documentation for GTBIMDIR    version 1.1    12/02/91
  2. Copyright (C) 1990-91 Ted Harper
  3.  
  4.  
  5. Free distribution and use of _unmodified_ executable code expressly permitted.
  6.  
  7. This program is designed to allow universal downloads from BBSs running
  8. GT-Power with the BiModem external protocol. Because of its design, the
  9. normal "files_db" database provided by GT is not usable by BiModem. In the
  10. past, this has meant that files can only be downloaded from one area per
  11. invokation of BiModem, and also that duplicate uploads are not thoroughly
  12. screened.
  13.  
  14. GTBIMDIR takes advantage of a recently-introduced feature of BiModem which
  15. allows for a list of directories to be searched for requested downloads to be
  16. passed to the driver. This list is determined from GTDIR.BBS and from the
  17. current user's GTUSER.BBS record. At the same time, a list of _all_ directories
  18. accessible to GT is created (BiModem can use this to check for duplicate
  19. uploads).
  20.  
  21. It is intended that GTBIMDIR is run in BIRX.BAT and BITX.BAT just prior to the
  22. invokation of BiModem in HOST mode. This ensures any on-the-fly changes made
  23. by the sysop to the user's access level (or to GTDIR.BBS) are reflected. The
  24. program searches in the current GTPATH directory for GTUSER.BBS and GTDIR.BBS.
  25. If either cannot be found or opened successfully, the program will abend with
  26. a message and return ERRORLEVEL 1 to DOS.
  27.  
  28. As GTBIMDIR runs, it builds two output files in the GTPATH (or another user-
  29. specified) directory. These are BIUP.BBS and BIDOWN.BBS - respectively the
  30. list of directories to check for duplicate uploads in, and the list to search
  31. for requested downloads. BiModem is given access to these by means of command
  32. line arguments. Following is a sample BITX.BAT (or BIRX.BAT) - this is also
  33. available in the distribution archive.
  34.  
  35. GTBIMDIR accepts two parameters, both of which are optional. The first is the
  36. logical access level to be given to users without download permission - this is
  37. explained later in this document. The second is the path for the two output
  38. files - note that if you want to specify an output path, you _must_ code a "No
  39. Downloads" level as well (the parser is pretty dumb <grin>).
  40.  
  41. The default for the "No Downloads" user level is "Z" and the default output
  42. file path is the GTPATH directory. For most systems, these defaults will be
  43. fine (i.e. you should normally run GTBIMDIR with no arguments), but the options
  44. are there if you need to tweak things.
  45.  
  46. Sample command lines for GTBIMDIR :-
  47.  
  48. GTBIMDIR            { access level Z to users without d/l, output to GTPATH }
  49. GTBIMDIR z          { use access level "z" for users who can't download }
  50. GTBIMDIR Z E:\WORK  { use a directory other than GTPATH for output files }
  51.  
  52. [ start of sample BiModem batch file ]
  53. @echo off
  54. rem
  55. rem   Batch file for BIMODEM
  56. rem
  57. H:\gt\gtbimod %1 %2 H:\gt\bimodem\
  58. if errorlevel 4 goto mail
  59. if errorlevel 3 goto host
  60. if errorlevel 2 goto term
  61. goto end
  62.  
  63. :term
  64. H:\gt\bimodem\bipath  H:\gt\bimodem\bimodem.pth
  65. if errorlevel 1 goto end
  66. H:\gt\bimodem\bibat   H:\gt\bimodem\bimodem.cfg
  67. if errorlevel 1 goto end
  68.  
  69. :mail
  70. H:\gt\bimodem\bimodem /P H:\gt\bimodem\bimodem.pth /C H:\gt\bimodem\bimodem.cfg
  71. goto end
  72.  
  73. :host
  74. H:\gt\bimodem\gtbimdir
  75. if errorlevel 1 goto end
  76. H:\gt\bimodem\bimodem /C H:\gt\bimodem\bimodem.cfg    ) This is supposed to
  77.          /N %GTPATH%\bidown.bbs /J %GTPATH%\biup.bbs  ) be _one_ long line!
  78.  
  79. :end
  80.  
  81. [ end of sample BiModem batch file ]
  82.  
  83. Clearly, you will have to change the path to the GT and BiModem support files
  84. to support your particular configuration.
  85.  
  86. The way the program works is to get the user's current access level and
  87. privileges from GTUSER.BBS. It then reads GTDIR.BBS and determines what
  88. file areas the user should have download access to (including ones which the
  89. sysop has imposed an "=" condition on) - these are placed in the file
  90. BIDOWN.BBS in the GT directory. At the same time, the paths of _all_ file
  91. areas listed in GTDIR.BBS are placed in BIUP.BBS, which is a list of
  92. directories to check for duplicates before allowing each upload.
  93.  
  94. Two overrides are placed on the above operation. Firstly, if a user is a sysop
  95. (SY is specified in the entry for their level in GTPASSWD.BBS and therefore in
  96. GTUSER.BBS), they have download access to _all_ file areas listed in GTDIR.BBS.
  97. Secondly, if a user is not permitted to download (neither DN or SY specified),
  98. they are processed by GTBIMDIR as a class "Z" user (or another class specified
  99. on the command line), with download access only to areas of that level or
  100. lower.
  101.  
  102. At present, GTBIMDIR does _not_ tell BiModem of a time or bytes-to-transfer
  103. limit for the current session. This is not particularly tricky, except that
  104. BiModem expects the limit as a command-line parameter, rather than as the
  105. contents of a text or external configuration file. If people want this feature
  106. included in GTBIMDIR, let me know and I'll modify the program to "spawn"
  107. BIMODEM.COM (so that I have total control over the command line), rather than
  108. execute it as a following line in the BIxx.BAT file.
  109.  
  110. If you have any suggestions for improving the operation of GTBIMDIR, or find a
  111. <wince shudder> bug, drop me a message at either of the bulletin
  112. boards below :-
  113.  
  114.        The Big Apple                        The Poet's Dilemma
  115.        Sydney, Australia                    Sydney, Australia
  116.        GTNet 302/021                        GTNet 302/000
  117.        Phone +61 2 764-3410 (24 hrs)        Phone +61 2 804-6412  (24 hrs)
  118.  
  119.  
  120. ted harper
  121. 12-Feb-91
  122.  
  123.  
  124. Release History
  125. ---------------
  126. 0.1   06/02/91    Initial "alpha" release.
  127. 1.0   10/02/91    First public release - the alpha went so surprisingly well
  128.                   that a wider beta test was dispensed with.
  129. 1.1   12/02/91    Correctly skip lines in GTDIR not containing path info.;
  130.                   Two command-line options added per user request (thanks ST).
  131.